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CHAPTER  1 
Introduction 


CAT  (short  for  CATALOG*  is  a  program  whose  function  is  to  maintain  and 
selectively  display  elements  of  a  catalog  of  a  group  of  disks.  This 
catalog  contains  the  names  of  all  files  on  these  disks  except  for  those 
specifically  omitted  by  the  user  and  the  names  of  the  disks  themselves. 
CAT  is  designed  to  give  the  user  the  ability  to  quickly  answer  the 
question:  What  files  do  I  have  and  where  are  they? 

This  is  a  relatively  simple  question,  but,  if  you  are  a  user  of  CP/M 
who  has  more  than  10  disks  with  files  on  them,  you  may  not  find  this  to  be 
an  easy  question  to  answer  quickly.  Manual  systems  of  keeping  track  of 
this  information  are  sometimes  quite  good;  however,  a's  the  number  of  disks 
grows  and  the  amount  of  information  to  keep  track  of  grows  correspondingly, 
the  burdon  of  housekeeping  becomes  cumbersome.  CAT  is  a  program  which  is 
designed  to  relieve  this  burdon. 

CAT  performs  three  basic  functions  —  CATALOG,  UPDATE,  and  STATUS. 
The  CATALOG  function  reports  on  the  contents  of  a  CATALOG  File.  The  user 
may  specify  the  files  he  wants  to  search  for  and  the  disks  he  wants  to 
search  on,  and  the  CATALOG  Function  will  scan  a  CATALOG  File  and  list  all 
files  matching  his  specification  and  all  disks  said  files  reside  on.  The 
UPDATE  function  updates  the  contents  of  a  CATALOG  File  by  examining  the 
disk  directory  of  the  disk  to  be  updated,  selecting  those  files  specified 
by  the  user,  and  changing  the  contents  of  the  CATALOG  File.  Thirdly,  the 
STATUS  function  reports  on  the  current  environment  of  the  CAT  program, 
including  such  information  as  the  default  function  and  the  name  of  the 
CATALOG  File. 

CAT  supports  many  useful  and  unique  features,  including: 

—  Wild  card  specification  of  file  names  and  disk  names 

—  Negative  selection  (i.e.,  specifying  file  names  NOT  to  be 

selected) 

—  Flexibility  in  setting  and  changing  the  default  conditions  of 
CAT  itself 


—  The  ability  to  support  more  than  one  CATALOG  File 

—  User-selectable  Printer  output  from  the  CATALOG  Function  and 
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Console  output  from  the  UPDATE  Function 


CAT,  then,  is  an  attempt  to  answer  a  simple  question,  and  it  is  felt 
that  as  the  user  becomes  increasingly  more  familiar  with  the  usage  of  this 
program,  he  will  find  this  simple  question  quite  easy  to  answer.  This 
nanual  is  a  user's  guide  to  the  use  of  CAT.  The  first  chapters  describe 
CAT  a ni  how  to  use  it,  and  the  latter  chapters  contain  error  information 
and  a  sample  terminal  session  containing  displays  of  output  from  CAT 
exactly  (or  nearly  so)  as  it  would  appear  on  the  user's  console. 
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CHAPTER  2 

The  CATALOG  Pile  and  NAMEDISK 


The  CATALOG  File  is  the  file  containing  the  information  for  CAT  to 
build  upon  and  retrieve  and  display  to  the  user.  It  is  a  file  named 

filename  .CAT 


and  it  is  divided  into  two  parts  — 

—  A  list  of  files  to  be  excluded  from  the  CATALOG  File  for  every 

disk 

—  The  names  of  the  files  and  disks  in  the  CATALOG  File 


The  CATALOG  File  is  a  CP/M-standard  ASCII  text  file  and  it  may  be 
edited  by  a  CP/M  compatable  editor.  The  first  character  of  a  CATALOG  File 
MUST  be  a  '('.  The  list  of  files  to  be  excluded  from  the  CATALOG  File  is 
enclosed  by  '('  and  This  is  followed  by  the  names  of  the  files  to  be 
excluded  (one  per  line)  and  a  closing  '»'  as  the  last  character  of  a  line. 
Examples  of  a  list  of  excluded  files  are  — 


Example  l 


( 

> 


Example  2 


( 

XDIR.COM 

PIP.COM 

) 


Example  3 

(XDIR.COM 

PIP.COM) 


Example  4 


(XDIR.COM 

PIP.COM 

) 


In  Example  l,  no  files  are  excluded;  in  Examples  2-4,  v  the  files 
XDIR.COM  and  PIP.COM  are  excluded.  It  is  common  practice  to  exclude  those 
files  which  appear  on  all  (or  almost  all)  of  the  disks  since  such 
information  leads  to  a  large  number  of  entries  for  these  files  being  made 
In  the  CATALOG  Pile. 

The  rest  of  a  CATALOG  File  contains  the  names  of  the  files  and  disks 
in  the  CATALOG.  This  list  is  in  alphabetical  order  by  file  name,  file 
type,  disk  name,  and  disk  type.  The  file  names/types  are  separated  from 
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the  disk  names/ types  by  a  comma.  For  example. 


Example  1 


Example  2 


( 

XDIR.COM 

PIP.COM 

) 

-SOURCE .A00 , SOURCE .A00 
-SOURCE .A01 , SOURCE . AOl 
FILEl. ASM, SOURCE. A00 
FILE 1 . ASM , SOURCE . AOl 
FILEl .COM, SOURCE. A00 
MYFILE. ASM, SOURCE. AOl 
MTFILE.COM, SOURCE. AOl 
TEST. ASM, SOURCE. AOO 


(XDIR.COM 

PIP.COM> 

-SOURCE . AOO , SOURCE . AOO 
-SOURCE. AOl , SOURCE. AOl 
FILEl. ASM, SOURCE. AOO 
FILEl. ASM,SOURCE. AOl 
FILEl .COM, SOURCE. AOO 
MYFI LE . ASM , SOURCE . AO l 
MYFILE.COM, SOURCE.AOl 
TEST. ASM, SOURCE. AOO 


In  the  above  example,  both  files  are  valid  CATALOG  Files.  Note  that 
in  both  cases,  the  files  XDIR.COM  and  PIP.COM  are  excluded  from  the  entries 
and  the  entries  are  in  alphabetical  order  by  ASCII  collating  sequence. 

The  first  entries  of  any  CATALOG  File  will  always  be  the  excluded  file 
list,  and  an  empty  CATALOG  File  will  contain  just  this  information.  If  the 
CATALOG  File  is  not  empty,  the  next  group  of  entries  will  be  the  names  of 
the  disks  in  the  catalog  preceded  by  signs.  This  situation  occurs 
because  all  disks  are  named  under  CAT,  and  these  names  take  the  form  of  an 
empty  file  whose  name  is  '-dskname.typ* .  To  allow  the  user  to  easily  name 
his  disks,  the  program  NAMEDISK  is  used  in  conjunction  with  the  CAT 
program.  It  is  executed  by  mounting  a  disk  to  be  named  in  drive  B:  and 
typing  NAMEDISK  at  the  console  (assuming  that  a  disk  is  mounted  in  drive  A: 
containing  the  CAT  and  NAMEDISK  programs) .  The  general  form  for  invoking 
NAMEDISK  is  'NAMEDISK  x:',  and  if  'x:'  is  specified,  then  that  particular 
disk  will  be  named  (like,  'NAMEDISK  A:'  names  the  disk  in  drive  A:),  and 
the  disk  in  drive  B:  will  be  named  if  'x:'  is  not  specified.  When 
NAMEDISK  prompts  for  a  disk  name  and  type,  the  user  should  type 
'dskname.typ',  and  the  file  '-dskname.typ'  will  be  created,  thereby  naming 
the  disk.  The  normal  CP/M  intra-line  editing  commands  (~U,  <DEL>,  “R, 
etc.)  are  supported  by  NAMEDISK. 

The  remaining  entries  in  a  CATALOG  File  are  the  names  of  the  files  and 
disks  in  alphabetical  order. 

CATALOG  Files  must  be  initialized  by  the  user.  "Empty*  CATALOG  Files 
contain  just  the  names  of  the  excluded  files  surrounded  by  '('  and  ')'. 
Once  initialized,  CAT  can  be  used  to  make  all  other  entries  into  the  files. 
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CHAPTER  3 

The  CATALOG,  UPDATE,  and  STATUS  Functions 


As  mentioned  earlier,  the  CAT  program  performs  three  basic  functions 
—  CATALOG,  UPDATE  and  STATUS.  The  CATALOG  Function  displays  selected 
information  from  the  current  CATALOG  File,  the  UPDATE  Function  updates  the 
contents  of  the  current  CATALOG  File  for  a  particular  disk,  and  the 
STATUS/ENVIRONMENT  Function  displays  the  current  default  settings  of  the 
CAT  program  and  allows  the  user  to  change  them. 


The  CATALOG  Function 


The  CATALOG  Function  displays  selected  information  from  the  current 
CATALOG  File.  This  information  includes  the  names  of  the  selected  files 
and  the  names  of  the  selected  disks  they  reside  on.  For  the  purpose  of 
this  discussion,  let's  assume  that  the  default  function  for  CAT  is  CATALOG. 
The  CAT  command  by  itself,  then,  would  display  the  contents  of  the  entire 
CATALOG  File.  This  listing  would  include  the  names  of  all  files  in 
alphabetical  order  followed  by  the  names  of  all  the  disks  they  reside  on  in 
alphabetical  order.  See  the  last  chapter  for  examples. 

With  the  default  function  set  to  CATALOG,  the  general  form  for  CAT 
would  be 


CAT  filename. typ  dskname.typ  /o 

where  'filename. typ'  and  'dskname.typ'  may  contain  wild  cards  and  '/o'  is 
zero  or  more  options.  Examples  of  valid  forms  and  their  meanings  are  — 

—  CAT  *.COM  —  display  all  .COM  files  and  the  disks  they  reside 
on 

—  CAT  *.COM  *.A7?  —  display  all  .COM  files  on  disks  whose  type 
begins  with  the  letter  A 

—  CAT  *.COM  *.A??  /N  —  display  all  files  which  are  NOT  .COM 
files  on  disks  whose  type  begins  with  the  letter  A 
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—  CAT  S*.MAC  WVCR080.*  —  display  all  files  beginning  with  the 
letter  S  and  having  a  type  of  .MAC  on  all  disks  whose  name  is  MACRO80 


As  the  user  can  note,  the  third  example  employed  the  'A*'  option;  this 
option  negates  the  file  name  selection.  That  is,  if  a  match  is  found  and 
Af  is  on,  then  it  is  declared  to  be  a  no  match;  otherwise,  a  match  occurs. 

Command  options  which  affect  the  CATALOG  Function  are  — 

—  /C  —  force  the  CATALOG  Function;  the  CATALOG  Function  is 
engaged  regardless  of  what  the  default  function  is 

—  /F  <delim>  <filename>  <delim>  —  declare  the  name  of  the 
CATALOG  File  to  be  'filename.CAT1;  this  forces  the  CATALOG  function  to  be 
performed  on  the  specified  CATALOG  File 

—  /L  —  toggle  listing  of  selected  files;  if.  listing  is  on,  the 

output  from  the  CATALOG  Function  will  appear  on  the  user's  LST:  device. 

This  toggles  the  default  listing  setting;  that  is,  if  listing  is  engaged  by 
default,  this  disengages  it,  and  vice-versa. 

—  /N  —  negate  selection.  Select  those  files  which  do  NOT  match 
the  ' filename. typ*  wild  card. 

—  /T  —  toggle  default  CATALOG /UPDATE  Function;  if  UPDATE  is  on 
by  default,  CATALOG  will  be  engaged,  and  vice-versa. 


Examples  of  valid  CAT  commands  are  — 

CAT  *.COM  /N/F'CPMUG'/C 

—  CATALOG  Function,  Negate  Selection,  and  CATALOG 
files  on  CPMUG.CAT 

CAT  *. ASM  *.A??  /L/F/MASTER/ 

—  CATALOG  Function  (assumed! ,  toggle  listing,  and 
CATALOG  files  on  MASTER. CAT 

CAT  -*.* 

—  CATALOG  Function  (assumed);  since  all  files  beginning 
with  a  '-'  are  selected,  then  only  the  names  of 
the  disks  will  be  displayed 


The  UPDATE  Function 


The  UPDATE  Function  updates  the  contents  of  the  current  CATALOG  File 
for  a  particular  disk.  Under  the  normal  mode  of  operation,  the  CATALOG 
File  and  the  CAT  program  reside  on  the  disk  on  drive  A;  and  the  disk  to  be 
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updated  resides  on  drive  B: ,  although  this  can  be  changed.  The  general 
form  of  the  CAT  command  as  used  for  the  UPDATE  Function  is  — 

CAT  x:filename.typ  /o 

where  'x:'  may  be  used  to  specifically  identify  the  drive  on  which  the  disk 
to  be  updated  resides,  ' filename. typ'  specifies  which  files  are  to  be 
entered  into  the  CATALOG  File,  and  '/o'  are  options  pertaining  to  the 
UPDATE  Function.  Valid  forms  of  this  command  are  — 

—  CAT  A:  —  UPDATE  all  files  on  drive  A: 

—  CAT  *.COM  /N  —  UPDATE  all  files  which  are  NOT  .COM  files  on 

drive  B: 

—  CAT  A  —  UPDATE  all  files  on  drive  B:  and  list  the  files  as 
they  are  being  updated 


The  following  are  the  options  valid  under  the  UPDATE  Function  and 
their  meanings  — 

—  /F  <delim>  <filename>  <delim>  —  UPDATE  on  the  specified 
CATALOG  File  (like  the  /F  option  for  CATALOG) 

—  A  —  toggle  listing  of  selected  files.  If  the  listing  is  on, 
then  the  names  of  the  files  selected  for  the  UPDATE  will  be  displayed  with 
a  count  of  the  number  of  files,  and,  as  the  UPDATE  progresses,  the  names  of 
files  not  previously  in  the  CATALOG  File  are  displayed  in  the  form 

Add:  filename. typ 

and  the  names  of  files  deleted  from  the  CATALOG  File  because  they  are  no 
longer  on  this  disk  are  displayed  in  the  form 

Delete:  filename. typ 

The  A  flag  toggles  the  default  listing  mode;  that  is,  if  listing  is  ON  by 
default,  A  turns  it  OFF,  and  vice-versa. 

—  /N  —  negate  selection.  This  specifies  that  a  match  is  NOT  to 
be  made  if  the  wild  card  filename. typ  specification  matches  as  in  the 
CATALOG  Function. 

—  /T  —  toggle  default  CATALOG/UPDATE  Function.  If  the  default 
function  is  CATALOG,  then  the  function  to  be  performed  will  be  UPDATE,  and 
vice-versa. 


—  /U  —  force  the  UPDATE  Function  to  be  performed.  If  there  is 
a  conflict  and  both  AJ  and  /C  are  specified,  then  the  option  specified  last 
will  take  affect. 
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The  STATUS  Function 


The  STATUS/ENVI RONMENT  Function  displays  the  current  default  settings 
of  the  CAT  program  and  allows  the  user  to  change  them.  The  default 
settings  affected  by  this  function  are  — 

—  The  name  of  the  CATALOG  File 

—  The  default  CAT  Function  (CATALOG  or  UPDATE* 

—  The  default  setting  for  the  listing  (/L» 


The  CAT  options  under  the  STATUS/ENVIRONMENT  Function  are  — 

—  /C  —  set  the  function  to  CATALOG 

—  /E  —  display  the  ENVIRONMENT  of  the  CAT  program  on  the  user's 
console  and  return  to  CP/M  without  performing  a  change  to  the  CAT  program 
on  disk.  If  any  options  such  as  /C  or  /U  are  specified  in  the  same  command 
line,  the  resulting  environment  is  displayed. 

—  /F  <delim>  <filename>  <delim>  —  set  the  name  of  the  CATALOG 

File 

—  /L  —  toggle  the  listing  flag 

—  /S  —  save  the  current  ENVIRONMENT  of  CAT  on  disk  and  return 
to  CP/M.  After  the  save  is  complete,  the  new  environment  is  displayed  to 
the  user  as  in  the  /E  option. 

—  /T  —  toggle  the  current  default  CATALOG/UPDATE  Function 

—  /U  —  set  the  function  to  UPDATE 


The  /E  and  /S  commands  specifically  identify  the  STATUS  Function. 
When  any  CAT  command  line  contains  either  of  these  options,  then  the  STATUS 
Function  is  engaged  and  the  normal  CATALOG  or  UPDATE  is  not  performed.  If 
both  options  are  specified,  the  /S  takes  precedence. 

Examples  of  the  use  of  the  CAT  program  with  the  STATUS  Function  are  — 

—  CAT  /F' MASTER' /S  —  change  the  name  of  the  default  CATALOG 
File  to  'MASTER. CAT'  and  save  the  change  on  disk 

—  CAT  /E  —  display  the  current  environment  of  CAT 

—  CAT  /C/S/F/CPMU3/  —  change  the  name  of  the  default  CATALOG 
File  to  'CPMUG.CAT',  set  the  default  function  to  CATALOG,  and  save  the 
change  on  disk 

—  CAT  /L/U/E  —  toggle  the  listing  flag,  set  the  default 
function  to  UPDATE,  and  display  the  new  environment  without  changing  it  on 
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disk.  This  is  useful  in  seeing  what  an  environment  would  be  before 
changing  it  on  disk. 
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CHAPTER  4 
CAT  Error  Messages 


Informative  Messages 


++  CATALOG  Function  ++ 

++  CATALOG  Function  Complete  ++ 

These  messages  indicate  when  the  CATALOG  Function  is  beginning  and  is 
completed. 


-H-  UPDATE  Function  ++ 

++  UPDATE  Function  Complete  ++ 

These  messages  indicate  when  the  UPDATE  Function  is  beginning  and  is 
completed. 


Delete:  <filename.typ> 

Add:  <filename.typ> 

These  messages  appear  during  an  UPDATE  with  Listing  ON,  and  they 
indicate  that  the  specified  file  has  been  Deleted  from  or  Added  to  the 
CATALOG  File. 


Selected  Files  — 
nnn  Files  Selected 

These  messages  appear  during  an  UPDATE  with  Listing  ON,  and  the  first 
message  preceeds  the  names  of  the  files  selected  for  updating  and  the 
second  message  follows  this  list  and  gives  a  count  of  the  number  of  files 
in  the  list.  This  list  includes  the  names  of  the  files  excluded  by  the 
file  exclusion  part  of  the  CATALOG  File  if  they  were  selected. 


•H-  STATUS  Function  ++ 

This  message  indicates  when  the  STATUS  Function  is  beginning. 
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Listing  of  Selected  Piles  is  ON 
Listing  of  Selected  Piles  is  OPP 

These  messages  appear  in  a  STATUS  Function  display  and  indicate  the 
status  of  the  Listing  Flag. 


Default  Function:  UPDATE 
Default  Function:  CATALOG 

These  messages  appear  in  a  STATUS  Function  display  and  indicate  the 
default  function  which  is  currently  set. 


CATALOG  File:  <f ilename.CAT> 

This  message  appears  under  several  conditions  and  indicates  the  name 
of  the  CATALOG  Fite. 


Change  Complete 

This  message  appears  when  an  /S  option  is  invoked  and  the  new 
environment  of  CAT  is  successfully  copied  back  to  disk. 


No  Matching  Entries  in  Directory 

This  message  indicates  that  no  entries  were  selected. 


■H"  CAT  Interrupted  ++ 

This  message  appears  when  the  user  types  an  <E9C>  or  CTRL-C  during  a 
CAT  Function.  If  this  occurs  during  an  UPDATE,  then  the  current  CATALOG 
File  is  in  its  backup  state  and  has  the  name  '$CAT$.$$$'  and  should  be 
renamed;  if  this  occurs  during  a  CATALOG,  no  problems  should  be 
encountered. 


Type  CTRL-C  to  Abort  or  anything  else  to  Continue  - 
Self-explanatory. 


Please  set  Top  of  Form  — 

Self-explanatory.  This  messages  occurs  when  Listing  is  engaged  for 
the  CATALOG  Function. 
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Fatal  Error  Messages 


Invalid  Drive  Specification 
Self-explanatory. 


CATALOG  Name  too  Long  —  Aborting 

The  name  given  for  the  catalog  file  has  more  than  8  characters  in  the 
filename  portion  or  3  characters  in  the  filetype  portion  (f ilename.typ) . 


FILE  ERROR  —  Returning  to  CP/M 

An  error  occurred  while  trying  to  open,  close,  read,  or  write  to  the 
CATALOG  File.  Check  to  see  that  it  is  intact  and  has  its  proper  name  (is 
not  named  '$CAT$.$$$'» . 


ERROR  in  CATALOG  File  Name  Description  —  Aborting 
See  ’CATALOG  Name  too  Long  —  Aborting'  above. 


ERROR  —  File  Output  Error  to  CATALOG 

A  write  error  occurred  while  performing  an  UPDATE.  Possible  causes 
include  running  out  of  disk  or  directory  space. 


ERROR  —  Invalid  CATALOG  Structure 
ERROR  ON:  <f ilename.CAT> 

The  structure  of  the  CATALOG  File  is  not  valid.  Possible  causes 
include  not  specifying  the  omitted  files  or  just  an  empty  (>  if  there  are 
none. 


ERROR  —  Error  in  closing  CATALOG  File 

Self-explanatory.  The  backup  '$CAT$.$$$'  should  still  exist. 


ERROR  —  CATALOG  Format  Error  —  Premature  EOF 

See  'ERROR  —  Invalid  CATALOG  Structure'  above. 


ERROR  —  CATALOG  Format  Error  —  No  Beginning  ' (' 

See  'ERROR  —  Invalid  CATALOG  Structure'  above. 


ERROR  —  No  Directory  Space  for  New  CATALOG 
Sel f-explanatory . 


ERROR  —  No  Name  Present  on  Disk 

An  UPDATE  Function  was  attempted  on  a  disk  which  did  not  have  a  valid 
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disk  name  as  the  first  entry  of  its  sorted  directory.  Possible  causes 
include  the  name  not  being  present  and  another  file  containing  a  character 
less  than  in  the  ASCII  collating  sequence  as  the  first  character  of  its 
name. 


ERROR  —  Cannot  Open  CATALOG  Pile 

Self-explanatory.  Check  to  see  that  the  required  CATALOG  Pile  resides 
an  disk. 
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CHAPTER  5 

Sample  Terminal  Session 


The  following  is  a  series  of  screen  displays  illustrating  the  usage  of 
the  CAT  program.  These  displays  are  almost  exact  copies  of  the  output  from 
CAT  as  it  would  appear  on  the  user's  console?  the  differences  are  very 
minor. 

The  lines  starting  with  'A>'  indicate  information  typed  by  the  user 
(as  per  a  normal  CP/M  terminal  session) ,  and  the  rest  of  the  information  is 
that  produced  by  the  result  of  the  commands  typed. 
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A>XDIR  B: 

XDIR  VI. 6 


FILENAME. TYP  SIZE  FILENAME.  TYP  SIZE  FILENAME. TYP  SIZE 


-SYSTEM  .-06 

OK 

FORMAT 

.COM 

2K 

SYSGEN 

.COM 

2K 

USER32  .ASM 

18K 

HELP 

.COM 

2K 

TERM 

.COM 

6K 

USER32B  .ASM 

18K 

LIST 

.COM 

2K 

m 

.COM 

10K 

USER43  .ASM 

18K 

LOAD 

.COM 

2K 

ws 

.COM 

26K 

USER56  .ASM 

18K 

MEMTEST 

.COM 

2K 

WSMSGS 

.COM 

20K 

ABORTSU3.COM 

2K 

MOVC PM 

.COM 

10K 

XDIR 

.COM 

6K 

ASM  .COM 

8K 

MSBFIX 

.COM 

2K 

ZDT 

.COM 

6K 

COPY  .COM 

2K 

NAMEDISK.COM 

2K 

ZRUN 

.COM 

2K 

CPM56  .COM 

10K 

PIP 

.COM 

8K 

CPM 

.HLP 

32K 

DDT  .COM 

6K 

PRINT 

.COM 

4K 

HELP 

.HLP 

8K 

DENSITY  .COM 

2K 

RESOURCE.COM 

6K 

INDEX 

.HLP 

10K 

DUTIL  .COM 

6K 

S 

•COM 

2K 

WM 

.HLP 

4K 

ED  .COM 

6K 

SINGLE 

.COM 

2K 

NEWDISK 

.SUB 

2K 

EDIT80  .COM 

14K 

STAT 

.COM 

4K 

DISKS 

.TXT 

2K 

ERASE  .COM 

4K 

SUBMIT 

.COM 

2K 

51  ENTRIES  &  44  FILES  IN  DIRECTORY  —  162K  BYTES  REMAINING 
A>CAT  /?  ;  display  HELP  information 


CATALOG  VI. I 
CATALOG  COMMAND  — 

CAT  xifilename.typ  dskname.dsk  /o 
All  arguments  are  optional,  and  wild  cards  (*,?l  are 
permitted  in  "filename.typ"  and  "diskname.dsk". 
Options  are  — 

/C  =  invoke  CATALOG  Function  on  A: 

/E  *  display  CATALOG  Environment  on  CON: 

/F  <delim>  <FILENAME>  <delim>  *  declare 
name  of  CATALOG  File  ' FILENAME. CAT' ; 
at  most  8  characters  may  be  in  FILENAME 
/L  *  toggle  listing  of  selected  files 
/N  *  negate  selection 

If  this  option  is  given,  wild  card 
specifies  files  NOT  to  be  selected 
/S  *  save  CATALOG  Environment  on  disk 
/T  *  toggle  default  CATALOG/UPDATE  Function 
/U  *  invoke  UPDATE  Function  on  B:  (or  x:> 
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A>CAT  /E 

CATALOG  Vl.l 
++  STATUS  Function  ++ 

CATALOG  File:  MASTER  .CAT 

Default  Function:  CATALOG 
Listing  of  Selected  Files  is  OFF 
A>CAT  A/S 

CATALOG  Vl.l 
Change  Complete 
++  STATUS  Function  ++ 

CATALOG  File:  MASTER  .CAT 

Default  Function:  UPDATE 
Listing  of  Selected  Files  is  OFF 
AKAT  /E 

CATALOG  Vl.l 
++  STATUS  Function  ++ 

CATALOG  File:  MASTER  .CAT 

Default  Function:  UPDATE 
Listing  of  Selected  Files  is  OFF 
AX2AT  /T/S/L 

CATALOG  Vl.l 
Change  Complete 
++  STATUS  Function  ++ 

CATALOG  File:  MASTER  .CAT 

Default  Function:  CATALOG 
Listing  of  Selected  Files  is  ON 
A>CAT  /L/S 

CATALOG  Vl.l 
Change  Complete 
++  STATUS  Function  ++ 

CATALOG  File:  MASTER  .CAT 

Default  Function:  CATALOG 
Listing  of  Selected  Files  is  OFF 
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A>CAT  CAT. ASM 
CATALOG  VI. I 

Catalog  File:  MASTER 

++  CATALOG  Function  ++ 
Filename. Typ  Diskname.Dsk 

CAT  .ASM  ASM  .AO0 

++  CAT  Interrupted  ++ 

A>CAT  CAT.* 

CATALOG  VI. 1 

Catalog  File:  MASTER 

++  CATALOG  Function  ++ 
Filename.Typ  Diskname.Dsk 
CAT  .ASM  ASM  .A00 

CAT  .COM  HELP  .-09 

-H-  CAT  Interrupted  +•+ 

A>CAT  CAT.*  *.A?? 

CATALOG  VI. I 

Catalog  File:  MASTER 

++  CATALOG  Function  ++ 
Filename. Typ  Diskname.Dsk 
CAT  .ASM  ASM  .A00 

CAT  .COM  PASTER  .A04 

-H-  CAT  Interrupted  ++ 

A>CAT  *.*  ASM. A?? 


CATALOG  VI. I 

Catalog  File:  MASTER 

-H-  CATALOG  Function  -H- 


Filename. Typ 

Diskname.Dsk 

-ASM 

•  A00 

ASM 

.A00 

ASM 

.COM 

ASM 

.A00 

ASM 

.HLP 

ASM 

.A00 

ASM 

.SU3 

ASM 

.A00 

CAT 

.ASM 

ASM 

.A00 

CHES SPAT. ASM 

ASM 

•  A00 

CIO 

.ASM 

ASM 

.A00 

CKSUM 

.ASM 

ASM 

.AGO 

COMPARE 

.ASM 

ASM 

.A00 

DUTIL 

.ASM 

ASM 

•  A00 

ED 

.COM 

ASM 

.A00 

FILEO 

.ASM 

ASM 

.A00 

GAMEPATl 

.ASM 

ASM 

.A00 

GAMEPAT2 

.ASM 

ASM 

.A00 

HELP 

.ASM 

ASM 

.A00 

HELP 

.COM 

ASM 

.A00 

++  CAT  Interrupted  ++ 

A>CAT  -*.* 


CATALOG  VI. I 

Catalog  File:  MASTER 

•H-  CATALOG  Function  -H- 
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.CAT 

Diskname.Dsk  Diskname.Dsk 
BACK4  .A09  SRC4  .A03 

.CAT 

Diskname.Dsk  Diskname.Dsk 
BACK4  .A09  SRC4  .A03 

HELP  .D06  MASTER  .A04 

.CAT 

Diskname.Dsk  Diskname.Dsk 
BACK4  .A09  SRC4  .A03 

.CAT 

Diskname.Dsk  Diskname.Dsk 


.CAT 


Diskname.Dsk 


Diskname.Dsk 


Diskname.Dsk 


Diskname.Dsk 


Page  17 


The  User's  Manual  for  CAT 


Filename. Typ  Diskname.Dsk  Diskname.Dsk  Disk name. Dsk 


-ALGOL  .B05 

ALGOL 

.805 

-ASM  .A00 

ASM 

.A00 

-BACK1  .A03 

BACK1 

.A03 

-BACK 2  .BOO 

BACK  2 

.BOO 

-BACK 3  .C05 

BACK3 

.C05 

-BACK4  .AO 9 

BACK4 

.A09 

-BACKS  .D09 

BACKS 

.D09 

-BASICE  .B09 

BASICE 

.B09 

-C  .A02 

C 

.AO  2 

-C BASIC  .B08 

CBASIC 

.B08 

-COBOL  .C05 

COBOL 

.COS 

-COMP  .AOl 

COMP 

.AOl 

-COMP  .C08 

COMP 

.C08 

-COMP  .D02 

COMP 

.DO  2 

-C0MPBAK.D03 

COMPBAK 

.D03 

-COMPBAK.D04 

COMPBAK 

.D04 

-C0MPBAK.D05 

COMPBAK 

.D05 

-CPM32  .A06 

CPM32 

.A05 

-CPM32  .A07 

CPM32 

.A07 

-FORTH  .D00 

FORTH 

.D00 

-FORTRAN. B07 

FORTRAN 

.B07 

Type  CTRL-C  to 

Abort  or  anything  else  to  Continue  - 

Filename.Typ 

Diskname.Dsk  Diskname.Dsk  Diskname.Dsk 

-GAMES  .-07 

GAMES 

.-07 

-HELP  .-03 

HELP 

.-03 

-HELP  .DOS 

HELP 

.DOS 

-MAC  .D01 

MAC 

.D01 

-MACRO80.C00 

MACROS 0 

.COO 

-MACR080.C02 

MACRQ80 

.C02 

-MASTER  .A04 

MASTER 

.A04 

-MBASIC  .C07 

MBASIC 

•C07 

-PASMT  .A05 

PASMT 

.A05 

-PASZ  .C09 

PASZ 

.C09 

-PERS0NL.-04 

PERSONL 

.-04 

-SMAL  .COl 

SMAL 

.COl 

-SRC1  .B04 

SRCl 

.B04 

-SRC 2  .B05 

SRC2 

.B05 

-SRC 3  .C04 

SRC3 

.C04 

-SRC4  .AO 9 

SRC4 

.A03 

-SRC5  .D03 

SRC5 

.D03 

-STOIC  .D07 

STOIC 

.D07 

-SYSTEM  .-05 

SYSTEM 

.-06 

-SYSTEM  .B03 

SYSTEM 

.B03 

-TEXT1  .B01 

TEXTl 

.B01 

Type  CTRL-C  to 

Abort  or  anything  else  to  Continue  - 

Filename.Typ 

Diskname.Dsk  Diskname.Dsk  Diskname.Dsk 

-TEXT2  ,B02 

TEXT2 

.802 

-TEOT3  .CO  3 

TEXT  3 

.C03 

-H-  CAT  Interrupted  ++ 
A>CAT  S*.MAC  MACRO.* 


Diskname.Dsk 


Diskname.Dsk 


Diskname.Dsk 


CATALOG  VI. I 

Catalog  File:  MASTER  .CAT 
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++  CATALOG  Function  ++ 

Filename. Typ  Diskname.Dsk  Diskname.Dsk  Disk name. Dsk  Diskname.Dsk 

++  CATALOG  Function  Complete  ++ 

A>CAT  S*.MAC  MACRO*.* 

CATALOG  VI. 1 

Catalog  File:  MASTER  .CAT 

++  CATALOG  Function  ++ 


Filename.Tvp 

Diskname.Dsk  Diskname.Dsk  Diskname.Dsk  Disknane.Dsk 

S 

.MAC 

MACR080  .COO 

SIFILEtO.MAC 

MACR080  .C02 

S2FILEI0.MAC 

MACROS 0  .CO 2 

S3FILEIO.MAC 

MACRO-30  .C02 

SBDOS 

.MAC 

MACROS 0  .C02 

SCAPS 

.MAC 

MACROS 0  .CO 2 

SCOOOT 

.MAC 

MACRO30  .CO 2 

SCIN 

.MAC 

MACR030  ,C02 

SCIO 

.MAC 

MACR080  .C02 

SCLOUT 

•MAC 

MACROS 0  .C02 

-H-  CAT  Interrupted  ++ 
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A>CAT  A) 

CATALOG  VI. 1 

Catalog  File:  MASTER  .CAT 

++  UPDATE  Function  ++ 

18  Files  Selected 
++  UPDATE  Function  Complete  ♦+ 
AXTAT  /U/L 

CATALOG  VI. 1 


Catalog  File: 

MASTER 

.CAT 

+4-  UPDATE  Function 

++ 

Selected  Files  — 

-GAMES 

.-07 

CHESS 

.COM 

CHESS  .ZER 

HURKLE 

LIFE 

.ZER 

LIFE8 

.COM 

MJASIC  .COM 

PIP 

PONG 

.COM 

PTRN 

.ZER 

REVERSE  .BAS 

ROCKET 

TARG 

.ZER 

TIMESQ 

.COM 

TREK80  .ZER 

XDIR 

ZING 

.ZER 

ZRUN 

.COM 

18  Files  Selected 
++  UPDATE  Function  Complete  ++ 

A>CAT  A/S 

CATALOG  VI. I 
Change  Complete 
++  STATUS  Function  ++ 

CATALOG  File:  MASTER  .CAT 

Default  Function:  UPDATE 
Listing  of  Selected  Files  is  OFF 
A>CAT  *.COM  /N/L 

CATALOG  VI. 1 

Catalog  File:  MASTER  .CAT 

++  UPDATE  Function  ++ 

Selected  Files  — 

-GAMES  .-07  CHESS  .ZER  HURKLE  .BAS  LIFE 

PTRN  .ZER  REVERSE  .BAS  ROCKET  .BAS  TARG 

TREK80  .ZER  ZING  .ZER 


10  Files  Selected 


Delete: 

CHESS 

.COM 

Delete: 

LIFE8 

.COM 

Delete: 

MBASIC 

.COM 

Delete: 

PONG 

.COM 

Delete: 

TIMESQ 

.COM 

Delete: 

ZRUN 

.COM 

-H-  UPDATE  Function 

Complete 

A>CAT  * 

•ZER  /N/L 

CATALOG  VI. I 


Catalog  File: 

MASTER 

.CAT 

■H-  UPDATE  Function 

++ 

Selected  Files  — 

-GAMES  .-07 

CHESS 

.COM 

HURKLE  .BAS 

LIFE8 
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MS ASIC 

.COM 

PIP 

.COM 

PONG  .COM 

REVERSE 

.BAS 

ROCKET 

.BAS 

TIMESQ 

.COM 

XDIR  .COM 

ZRUN 

.COM 

12  Files  Selected 

Add: 

CHESS 

.COM 

Delete: 

CHESS 

.ZER 

Delete: 

LIFE 

.ZER 

Add: 

LIFE8 

.COM 

Add: 

MBASIC 

.COM 

Add: 

PONG 

.COM 

Delete: 

PTRN 

.ZER 

Delete: 

TARG 

.ZER 

Add: 

TIMESQ 

.COM 

Delete: 

TREK90 

.ZER 

Delete: 

ZING 

.ZER 

Add: 

ZRUN 

.COM 

++  UPDATE  Function 

Complete  -M- 

A>CAT  /L 

CATALOG  VI. 

L 

Catalog  File: 

MASTER 

.CAT 

-H-  UPDATE  Function 

++ 

Selected  Files  — 

-GAMES 

.-07 

CHESS 

.COM 

CHESS  .ZER 

HURKLE 

.BAS 

LIFE 

.ZER 

LIFE8 

.COM 

M3  ASIC  .COM 

PIP 

.COM 

PONG 

.COM 

PTRN 

.ZER 

FEVERSS  .BAS 

ROCKET 

.BAS 

TARG 

.ZER 

TIMESQ 

.COM 

TREK80  .ZER 

XDIR 

.COM 

ZING 

.ZER 

ZRUN 

.COM 

18  Files  Selected 
Add:  CHESS  .ZER 

Add:  LIFE  .ZER 

Add:  PTRN  .ZER 

Add:  TARG  .ZER 

Add:  TREK30  .ZER 

Add:  ZING  .ZER 

+f  UPDATE  Function  Complete  ++ 
A>CAT  A/S 

CATALOG  VI. I 
Change  Complete 
++  STATUS  Function  -H- 

CATALOG  File:  MASTER  .CAT 

Default  Function:  CATALOG 
Listing  of  Selected  Files  is  OFF 
A>CAT  *.*  GAMES.* 


CATALOG  VI. 1 

Catalog  File:  MASTER  .CAT 

■H-  CATALOG  Function  ++ 


Filename. Typ 

Diskname.Dsk  Diskname.Dsk 

Diskname.Dsk  Disk name. Dsk 

-GAMES  .-07 

GAMES 

.-07 

CHESS 

.COM 

GAMES 

.-07 

CHESS 

.ZER 

GAMES 

.-07 
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HURKLE 

.BAS 

GAMES 

.-07 

LIFE 

.ZER 

GAMES 

.-07 

LIFE3 

.COM 

GAMES 

.-07 

MBASIC 

.COM 

GAMES 

.-07 

PONG 

.COM 

GAMES 

.-07 

PTRN 

.ZER 

GAMES 

.-07 

REVERSE 

.BAS 

GAMES 

.-07 

ROCKET 

.BAS 

GAMES 

.-07 

TAFG 

.ZER 

GAMES 

.-07 

TIMESQ 

.COM 

GAMES 

.-07 

TREK80 

.ZER 

GAMES 

.-07 

ZING 

.ZER 

GAMES 

.-07 

ZRUN 

.COM 

GAMES 

.-07 

++  CATALOG  Function  Complete  ++ 
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0  j  SET  FOR  CATALOG  FUNCTION 

:ns  is  the  file  list  flag 


LXI  H,TBUFT  ;  PT  TO  COMMAND  STRING 

MOV  A,M  ;  GET  CHAR  CNT 


PAGE  5  —  SOURCE  LISTING  OF  CAT. ASM  3  AUGUST  1980 


PAGE  6  —  SOURCE  LISTING  OP  CAT. ASM  3  AUGUST  1980 


PAGE  8  —  SOURCE  LISTING  OF  CAT. ASM  3  AUGUST  1930 


LXI  O.FCBl+l  ;  PLACE  <SP>  IN  FILE  NAME  PART 

PUSH  D  }  SAVE  PTR 

XCHG  ;  DE  PTS  TO  1ST  CHAR,  HL  PTS  TO  FILE  NAME  PART 

MVI  B,8  ;  <SP>  OUT  FILE  NAME 

MVI  A,'  '  f  <SP> 


PAGE  9  —  SOURCE  LISTING  OP  CAT. ASM  3  AUGUST  1980 


o 

eo 

<n 


PAGE  12  —  SOURCE  LISTING  OF  CAT. ASM  3  AUGUST  1980 


PAGE  13  —  SOURCE  LISTING  OF  CAT. ASM  3  AUGUST  1930 


SOURCE  LISTING  OF  CAT. ASM  3  AUGUST  1980 


PAGE  15  —  SOURCE  LISTING  OP  CAT.ASM  3  AUGUST  1930 


4 


PAGE  20  —  SOURCE  LISTING  OP  CAT. ASM  3  AUGUST  1980 


POT$8YTE$COT  ;  DONE  W/LAST  POT? 

128 

FLUSH$CAT2  ;  YES  ...  CLOSE 

A,CTRLZ  ;  POT  ANOTHER  CTRL? 


PAGE  21  —  SOURCE  LISTING  OF  CAT. ASM  3  AUGUST  1930 


o 


*  CHECK  FOR  END  OP  DIR1  AND  FINISH  IF  SO 
FLUSH$DIR2: 

CPI  CTRLZ  ;  END  OF  DIR1? 

JNZ  FLUSH$DIR3 

CALL  PUT  ;  POT  CTRL-Z 


PAGE  23  —  SOURCE  LISTING  OP  CAT.ASM  3  AUGUST  1930 


PAGE  24  —  SOURCE  LISTING  OF  CAT. ASM  3  AUGUST  1980 


PAGE  25  —  SOURCE  LISTING  OF  CAT. ASM  3  AUGUST  1980 


PCRLFSPAGE 


PAGE  28  —  SOURCE  LISTING  OF  CAT. ASM  3  AUGUST  1990 


LDA  ENTRY$COUNT  ;  COUNT  DOWN 


WRITE  CATALOG  ENTRY  PROM  WORK  BUFFERS  TO  CAT 


<SP>  ENCOUNTERED  —  SKIP  TO  END  OF  FIELD 


PAGE  35  —  SOURCE  LISTING  OF  CAT. ASM  3  AUGUST  1980 


PASS  36  —  SOURCE  LISTIN3  OP  CAT. ASM  3  AUSUST  1930 


PAGE  37  —  SOURCE  LISTING  OF  CAT. ASM  3  AUGUST  1980 


PAGE  38  —  SOURCE  LISTING  OF  CAT. ASM  3  AUGUST  1980 


PAGE  41  —  SOURCE  LISTING  OP  CAT. ASM  3  AUGUST  1930 


v<t. 


LX I  D,FCB+l  ;  PT  TO  FN 

LDAX  0  ;  WILD? 

CPI  •  •  ;  NO  FN  MEANS  WILD 

JZ  SEARCH$DIRO 

CPI  V  ;  OPTION  CAUGHT,  SO  'WILD  ALSO 


PAGE  42  —  SOURCE  LISTING  OF  CAT. ASM  3  AUGUST  1930 


SOURCE  LISTING  Of  CVT.ASM  1  VjrpJST  1980 


PAGE  45  —  SOURCE  LISTING  OP  CAT. ASM  3  AUGUST  1930 


PAGE  46  —  SOURCE  LISTING  OP  CAT. ASM  3  AUGUST  1980 


PUSH  H  1  PUSH  D  !  PUSH  3  !  PUSH  PSW 
MOV  E,A  ;  CHAR  IN  E 

IWI  C,2  ;  PRINT  TO  CON: 

CALL  BDOS 

POP  PSW  !  POP  8  !  POP  D  !  POP  H 


PAGE  48  —  SOURCE  LISTING  OP  CAT.  ASM  3  AUGUST  1930 


PILL:  ;  PILL  MEMORY  PTED  TO  3Y  HL  WITH  CHAR  IN  A  POR  B  BYTES 

MOV  M,A  ;  PUT  CHAR 

I  NX  H  ;  PT  TO  NEXT 


PAGE  49  —  SOURCE  LISTING  OP  CAT. ASM  3  AUGUST  1930 


11*64+1  ;  11  BYTES/ENTRY;  64  EIWRIES  MAX;  END  IN  CTRL-Z 


PAGE  52  —  SOURCE  LISTING  OP  CAT. ASM  3  AUGUST  1930 


